Skip to content

fix(concordance): include CSEC2017 in Frameworks listing table#2

Merged
ryanstraight merged 1 commit into
mainfrom
fix/csec2017-frameworks-listing
Jun 10, 2026
Merged

fix(concordance): include CSEC2017 in Frameworks listing table#2
ryanstraight merged 1 commit into
mainfrom
fix/csec2017-frameworks-listing

Conversation

@ryanstraight

Copy link
Copy Markdown
Owner

What changed

One line in concordance/frameworks/index.qmd:

- contents: "*-*.qmd"
+ contents: ["*-*.qmd", "csec2017.qmd"]

Why

The Frameworks listing used a Quarto glob (*-*.qmd) that requires a hyphen in the filename. The CSEC2017 page is named csec2017.qmd (no hyphen), so it never matched the glob and was silently omitted from the rendered Frameworks table — even though the page itself exists and renders fine. The other seven framework pages (nice-v2, dcwf-v51, ecsf-v1, sfia-9, digcomp-22, csta-2017, cyberorg-k12) all have hyphens.

This matters because the ISCAP 2026 Concordance paper describes the Frameworks page as part of the instrument. A framework missing from its own corpus table is a visible defect.

Why broaden the glob instead of renaming the file

The csec2017 slug (no hyphen) is the established convention across the whole corpus:

  • the framework_summary slug is csec2017-v1
  • the ingest script is 010-ingest-csec2017.R
  • the alignment data/query files are all nice_csec2017_*

Renaming the page to csec-2017.qmd would make it the lone divergent spelling and churn the alignment query, homepage cards/links, and the curriculum-coordinator use-case. The glob broadening is a one-line change that leaves the naming convention intact.

Effect

  • The Frameworks table goes from 7 rows to 8, adding ACM/IEEE CSEC2017 (Global / Pedagogy / 8 units / 40 elements).
  • No files renamed, no links/xrefs/nav touched, no page content changed.
  • No duplicate-row risk: csec2017.qmd does not match *-*.qmd, so it is added exactly once.

Verification

Rebuilt frameworks/index.qmd; the rendered _site/frameworks/index.html now contains "ACM/IEEE CSEC2017" and links to all eight framework pages.

Reviewer note

This list-based contents retains the same latent trap for the next no-hyphen framework filename. A more durable pattern would be contents: "*.qmd" (the index page excludes itself automatically), but that is a larger change and out of scope here.

The Frameworks listing used `contents: "*-*.qmd"`, which requires a
hyphen in the filename. csec2017.qmd has no hyphen, so it never matched
the glob and was silently omitted from the rendered table even though
the page itself exists and renders.

Broaden the listing glob to also match the no-hyphen file rather than
renaming the page. The `csec2017` slug (no hyphen) is the established
convention across the corpus — the framework_summary slug is
`csec2017-v1`, the ingest script is `010-ingest-csec2017.R`, and the
alignment data/query files are all `nice_csec2017_*`. Renaming the page
would make it the lone divergent spelling and churn the query, homepage,
and use-case links.

The Frameworks table now shows all eight frameworks, including CSEC2017
(Global / Pedagogy / 8 units / 40 elements). This matters because the
ISCAP 2026 Concordance paper describes the Frameworks page as part of
the instrument; a framework missing from its own corpus table is a
visible defect.
@ryanstraight ryanstraight merged commit 183b93b into main Jun 10, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant